home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / badu23.zip / BADUSER.DOC < prev    next >
Text File  |  1992-12-08  |  12KB  |  302 lines

  1.  
  2.                        ============================
  3.                                  BADUSER!
  4.                        ============================
  5.  
  6.         One of the T&J Software Collection of multi-BBS door programs.
  7.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  8.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  9.  
  10.                         (c)1991,92 T&J Software
  11.  
  12.                        VERSION 2.3      11/27/92
  13.  
  14.                                     By
  15.  
  16.                                Tom Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.  
  22.                                   From
  23.  
  24.                                The T&J BBS
  25.                               (717)325-9481
  26.                         1200/2400/9600/19200/38400
  27.                                24 Hours/Day
  28.  
  29.  
  30. LATEST VERSION:
  31. ===============
  32. Please call the T&J BBS for the latest version of this program.
  33.  
  34. DISTRIBUTION:
  35. =============
  36. You may make this file available for downloading from your BBS or you may
  37. upload it to any BBS of your choice, provided that you do not make any
  38. changes to the contents of the archive (ZIP file). The archive and its
  39. individual contents may not be used by any service that charges any money
  40. whatsoever, without the written permission of the author.
  41.  
  42. LEGALITIES:
  43. ===========
  44.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  45.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  46.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  47.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  48.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  49.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  50.       OR BREACH OF ANY WARRANTY.
  51.  
  52. PROGRAM DESCRIPTION:
  53. ====================
  54. Have you ever had users that constantly drop carrier in door games? Do
  55. you have some users who cry over the scores etc..? Now you can lock these
  56. users from the doors of your choice! BadUser will check a text file
  57. maintained by you -- and will keep these unwanted users from playing
  58. those selected games/programs. The nice thing is they won't know what
  59. is wrong (if you select the STANDARD configuration). BadUser sends them
  60. no sign that it is being run except for a fake ERROR message which says
  61. "COM Port Error -- Returning to BBS". In CUSTOM mode, you may make and
  62. send a ANSI screen to the user.
  63.  
  64. If BadUser finds a "bad user" it will create a file called BAD.BAD. The
  65. DOOR.BAT file will see it and skip the main door program and head back
  66. to the BBS (see the sample batch file included).
  67.  
  68.  
  69. INSTALLATION:
  70. =============
  71.  
  72. Example configuration file for PCBOARD.SYS
  73. ------------------------------------------
  74.  
  75. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  76. T&J Software        <=-  (Change this to your BBS name)
  77. Tom                 <=-  (The Sysop's first name)
  78. Wildoner            <=-  (The Sysop's last name)
  79.  
  80. Example configuration file for USERS.SYS
  81. ----------------------------------------
  82.  
  83. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  84. T&J Software        <=-  (Change this to your BBS name)
  85. Tom                 <=-  (The Sysop's first name)
  86. Wildoner            <=-  (The Sysop's last name)
  87.  
  88. Example configuration file for DOOR.SYS
  89. ---------------------------------------
  90.  
  91. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  92. T&J Software        <=-  (Change this to your BBS name)
  93. Tom                 <=-  (The Sysop's first name)
  94. Wildoner            <=-  (The Sysop's last name)
  95.  
  96. Example configuration file for USERINFO.DAT
  97. -------------------------------------------
  98.  
  99. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  100. T&J Software        <=-  (Change this to your BBS name)
  101. Tom                 <=-  (The Sysop's first name)
  102. Wildoner            <=-  (The Sysop's last name)
  103. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  104.  
  105. Example configuration file for CALLINFO.BBS
  106. -------------------------------------------
  107.  
  108. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  109. T&J Software        <=-  (Change this to your BBS name)
  110. Tom                 <=-  (The Sysop's first name)
  111. Wildoner            <=-  (The Sysop's last name)
  112.  
  113. Example configuration file for DORINFOx.DEF
  114. -------------------------------------------
  115.  
  116. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  117.                           where 'x' is the BBS Node number.
  118. T&J Software        <=-  (Change this to your BBS name)
  119. Tom                 <=-  (The Sysop's first name)
  120. Wildoner            <=-  (The Sysop's last name)
  121.  
  122. Example configuration file for SFDOORS.DAT
  123. ------------------------------------------
  124.  
  125. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  126. T&J Software        <=-  (Change this to your BBS name)
  127. Tom                 <=-  (The Sysop's first name)
  128. Wildoner            <=-  (The Sysop's last name)
  129.  
  130. Example configuration file for CHAIN.TXT
  131. ----------------------------------------
  132.  
  133. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  134. T&J Software        <=-  (Change this to your BBS name)
  135. Tom                 <=-  (The Sysop's first name)
  136. Wildoner            <=-  (The Sysop's last name)
  137.  
  138. Example configuration file for GTUSER.BBS
  139. -----------------------------------------
  140.  
  141. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  142. T&J Software        <=-  (Change this to your BBS name)
  143. Tom                 <=-  (The Sysop's first name)
  144. Wildoner            <=-  (The Sysop's last name)
  145. 1                   <=-  (COM port number - defaults to 1)
  146. 1                   <=-  (Node number - defaults to 1)
  147.  
  148. This Door is multi-node  compatible so you may run more than 1 node from
  149. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  150. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  151. variables, (q.v.)
  152.  
  153. Environment Variables
  154. =====================
  155.  
  156. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  157. variables. Non-PCBoard systems may also use these variables by including
  158. the following in either your BBS batch or AUTOEXEC.BAT
  159.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  160.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  161. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  162. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  163. .CFG file for multi-node operation!
  164.  
  165. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  166. command line.  For example:
  167.  
  168.      LEMON30 LEMON.CFG /5
  169. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  170.      LEMON30 LEMON.CFG /%IRQ%
  171.  
  172. This tells the program to use IRQ 5 instead of the standard IRQ.
  173.  
  174.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  175.  systems. Seems Novell also uses the / character so something went screwy
  176.  somewhere. So I added the * (asterisk) which may be used instead of the /
  177.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  178.  and are interchangeable.
  179.  
  180. When specifying the location of the system file on line 1 of the doors .CFG
  181. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  182. and %wcnodeid%. Some examples:
  183.  PCBoard: 
  184.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  185.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  186.  
  187.  Wildcat!:
  188.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  189.  
  190. Non-PCBoard systems may use the PCB environment variables by setting them
  191. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  192.  SET PCBDRIVE=C:
  193.  SET PCBDIR=\BBSDIR
  194.  SET PCBNODE=1
  195.  
  196. Fossil Driver Support
  197. ---------------------
  198. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  199. Fossil driver instead of the standard COM ports, just put /FD on the command
  200. line when running the door. For example:
  201.      MYDOOR MYDOOR.CFG /FD
  202. indicates that a Fossil driver is present and should be used. If no Fossil
  203. driver is detected, DoorFrame will print a message to that effect and exit
  204. the door gracefully.
  205.  
  206.  
  207. Sysop Keys
  208. ==========
  209.  
  210. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  211.          written to DOOR.SYS and USERS.SYS
  212. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  213.          and/or written to DOOR.SYS and USERS.SYS
  214. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  215. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  216.          and/or written to DOOR.SYS and USERS.SYS
  217. F8    -  Returns the caller involuntarily to the BBS.
  218. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  219.          and/or written to DOOR.SYS and USERS.SYS
  220. F10   -  Activates SysOp CHAT mode within the DOOR.
  221. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  222. UP    -  Give the caller extra time while in the DOOR.  
  223. DN    -  Subtract time from the caller while in the DOOR. 
  224. HOME  -  HELP key for Status Line options.
  225. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  226. ALT-X -  PCBoard will exit after current caller logs off. Value is
  227.          passed to PCBoard. Not available on non-PCBoard systems.
  228.  
  229.  
  230. BATCH FILE SETUP!
  231. ================
  232.  
  233. ECHO OFF
  234. CD\WC30\DOOR\LEMON
  235. BADUSER BADUSER.CFG
  236. IF EXIST BAD.BAD GOTO QUIT
  237. LEMON LEMON.CFG
  238. :QUIT
  239. IF EXIST BAD.BAD DEL BAD.BAD
  240.  
  241. 1: Turn ECHO OFF -- not needed
  242. 2: Change to your door directory.
  243. 3: Run BadUser -- if a bad user is found the program will create a
  244.    small file called BAD.BAD.
  245. 4: Checks to see if BAD.BAD was created -- if it was it will skip to
  246.    QUIT and bypass the real door. If the BAD.BAD file is not found
  247.    your real door will operate as normal.
  248. 5: Your actual door program (however many lines it takes).
  249. 6: Batch file branch if a bad user was found.
  250. 7: Delete the BAD.BAD file if it is there.
  251.  
  252. To run in LOCAL mode simply enter:  BADUSER LOCAL
  253.  
  254.  
  255. EDITING THE BADUSER.LST FILE:
  256. =============================
  257. Use your favorite text editor to type in the bad user names. Simply add the
  258. names of the users to this file. One name per line.....
  259.  
  260. MODES:
  261. =====
  262. Setup the SYSOP.CFG file for CUSTOM or STANDARD mode. For STANDARD mode,
  263. just enter an S one line one of this file (it is not case sensitive and
  264. no "quotes" are needed. Standard mode simply tells the user that there is
  265. a COM PORT ERROR and returns to the board.
  266.  
  267. In CUSTOM mode, enter a C on line one and the screen that you would like
  268. to send to the user.
  269.                     LINE 1:  C
  270.                     LINE 2:  SCREEN.SCR
  271.  
  272. When you design your screen, save it with a home cursor not a clear screen.
  273. If you are using TheDraw greater than version 3.3, block save your screen!
  274. See TheDraw's documentation for this. Failure to use a block save will
  275. make your screen jump up one line.
  276.  
  277. FUTURE VERSIONS:
  278. ================
  279. --->> Let me know what you would like to see!
  280.  
  281. VERSION HISTORY:
  282. ================
  283. Version 1.00 ......... First release. 09/21/91
  284. Version 2.00 ......... Updated the door with new routines 03/14/92.
  285. Version 2.10 ......... Updated the door with new routines and added
  286.                        the CUSTOM or STANDARD option. 05-15-92
  287. Version 2.20 ......... Updated to newer door routines. 10-12-92
  288. Version 2.30 ......... New door routines, added support for fossil
  289.                        drivers. 11-27-1992
  290.  
  291. REGISTERING:
  292. ============
  293. None required. If you would like to send me a program you have written,
  294. that would be payment enough.
  295.  
  296.  
  297. That's all there is to it! If you have any problems or questions
  298. please feel free to call the T&J BBS at (717)325-9481 and join the
  299. T&J Software Conference.
  300.  
  301. See the registration form for other products from T&J Software.
  302.